home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
qbbs
/
1edit300.zip
/
1EDIT.DOC
next >
Wrap
Text File
|
1992-10-03
|
47KB
|
1,501 lines
+----------------------------------------+
| +----------------------------------+ |
| | -*- 1-Edit -*- | |
| +----------------------------------+ |
+----------------------------------------+
Version: 3.00
For
QuickBBS v2.75-2.76
by
Bob Ransom
Copyright (c) 1992
All Rights Reserved
+---------------------------------------------+
| TABLE OF CONTENTS |
+---------------------------------------------+
What Is 1-Edit ..................................... 2
Shareware & Warranty Info .......................... 3
FOSSILS, ANSI.SYS, and Other Requirements .......... 4
LOCAL.DEF File ................................ 5
Direct Screen Writes .......................... 6
Locked COM Ports .............................. 6
Directories ................................... 6
Command Line Syntax ................................ 8
Colors ........................................ 8
Drop to DOS Security Level .................... 8
Directory Commands ............................ 8
Blocking the Menu Editor ...................... 8
User Editor Security .......................... 8
Getting Started .................................... 10
Setting Up 1-Edit Within QuickBBS ............. 10
QuickBBS's External User Editor (*W command) .. 11
The Menu Editor .................................... 13
The User Editor .................................... 15
Mass Updates .................................. 15
Security "Jumping" (-J parameter) ............. 16
Editing Your Own User Record .................. 16
1-Edit Lite (1EDITL.EXE) ...................... 17
Drop To DOS ........................................ 18
Local Drop .................................... 18
Remote Drop ................................... 18
DOSSHELL.BAT .................................. 19
Multi-Node Setup ................................... 20
The -N Parameter .............................. 20
The -U Parameter .............................. 21
Registering 1-Edit ................................. 22
Keys .......................................... 22
Final Notes ........................................ 25
1-Edit Documentation Page 1
+---------------------------------------------+
| WHAT IS 1-EDIT? |
+---------------------------------------------+
1-Edit is a combined User Editor and Menu Editor for QuickBBS
v2.75-2.76 systems designed to work reliably from remote.
Features include:
- Built-in FOSSIL routines for easy to operate remote
performance.
- Complete editing capabilities of all User record
fields.
- Complete menu editing capabilities including
adding, deleting, renaming, and copying menus, plus
full editing of each menu.
- Full carrier-detection which returns to QuickBBS
when carrier is dropped.
- Automatic high-speed performance with locked ports
at up to 38,400 baud.
- Ability to work in multi-node setups.
- Status line showing user name, baud and modem
settings, and time remaining (registered versions
only.)
- User definable colors.
1-Edit Documentation Page 2
+---------------------------------------------+
| 1-EDIT: SHAREWARE & WARRANTY INFO |
+---------------------------------------------+
Here comes the dull stuff...
SHAREWARE INFO
--------------
This program is released to the public as shareware. This
means try the program and if you like it and continue to use
it, you must register it within a reasonable amount of time.
This program is not freeware nor public domain software;
rather it is copyrighted material with all rights reserved.
You are granted only a limited license to test this software
to see if it meets your needs.
You may copy 1-Edit and transfer it to others provided you
follow these brief rules:
1- You may not change the program, its documentation, any
ancillary programs or files included in the archive, or the
archive itself, in any way without express written consent
from me, the author.
2- You may not sell the program to others. This program may
be distributed on pay systems, but not on a "fee per download"
basis.
3- You may not distribute this product with any other products
without express written consent from me.
Registration of 1-Edit is a cheap 10 bucks and covers you for
all future releases of the program. More information on
registration is included later in this document.
WARRANTY
--------
No warranty of any kind, covering either hardware or software
damage, is expressed nor implied. If you choose to use this
program, you do so at your own risk.
1-Edit Documentation Page 3
+---------------------------------------------+
| FOSSILS, ANSI.SYS, and OTHER REQUIREMENTS |
+---------------------------------------------+
There are a few things you should know before attempting to
boot 1-Edit for the first time:
Software Version
----------------
This version, 3.00, of 1-Edit is designed to work with
QuickBBS v2.75 & 2.76. If you are, for some reason, still
running an older version of QuickBBS (2.64-2.66), please use
1-Edit v1.01.
FOSSIL Driver
-------------
1-Edit requires that a FOSSIL driver be installed and active
at all times. This shouldn't prove to be much of a hindrance
since 1-Edit was designed for remote use -- and QuickBBS also
requires the FOSSIL be installed and active. 1-Edit has been
tested under several versions of both the X00 and BNU drivers;
either should work fine. However, if you are using either as
a TSR (rather than as a standard "DEVICE="), you must make
sure that the FOSSIL isn't being removed from memory when you
shell or exit your BBS or mailer.
ANSI Graphics
-------------
1-Edit requires all users of the program to have the ANSI.SYS
driver installed -- both on the BBS side and on the remote
side. This shouldn't be much of a problem as I figure 99.98%
of all sysops do. If you're unfamiliar with ANSI.SYS and its
installation, please refer to your DOS manual. ANSI.SYS is
included with all versions of DOS.
I've received a few messages from sysops who would prefer that
the program *not* use ANSI graphics as they do their work from
non-ANSI machines (like VT-220 terms on a VAX). Someday I
hope to take care of this problem, making ANSI an option
rather than a requirement. I'm using ANSI not so much for
1-Edit Documentation Page 4
color as for cursor positioning and movement, and I haven't
quite figured a way around the use of ANSI.
DORINFO1.DEF and LOCAL.DEF
--------------------------
1-Edit requires a DORINFO1.DEF file to be present when
starting. First, some background on this file, then info on
how to get around the necessity of having it available to
1-Edit when using the program locally.
Anytime QuickBBS calls a child program (a door) via a Type 7
or Type 15 exit, it creates two files: a DORINFO1.DEF file and
an EXITINFO.BBS. Both contain information about the user
online at the time the door is started -- information like
baud rate, com port, time remaining, security level. When you
return to QuickBBS from the shell, both of these files are
deleted automatically -- which is why you can never find them
on your disk after running a door.
1-Edit uses only the DORINFO1.DEF file to get information
about the user. Because the file is required, and because one
won't always be available (such as when running 1-Edit
outside of QuickBBS), I've made the program search for a
second file called LOCAL.DEF. LOCAL.DEF is nothing but a copy
of a DORINFO1.DEF which should stay in your QuickBBS system
directory (usually C:\QBBS\). Just put it there and leave it
there, and 1-Edit will always know where to find it when it's
needed.
A copy of a LOCAL.DEF file is included in the 1-Edit archive.
You'll want to edit it to reflect your name and system name.
Here's what one looks like with my comments in braces { }:
---------------------------------------------------------
THE CREATIVE CONNECTION-SOUTHFIELD, MI-(313)559-9039
BOB {Sysop first name}
RANSOM {Sysop last name}
COM0 {Don't edit this! COM0 = Local}
0 Baud,N,8,1 {No need to edit this}
0 {This does nothing; just a zero}
BOB {User's first name}
RANSOM {User's last name}
SOUTHFIELD, MI {No need to edit; not used}
1 {Graphics mode; no need to edit]
32000 {Security level}
235 {Time remaining}
---------------------------------------------------------
1-Edit Documentation Page 5
Feel free to edit the LOCAL.DEF file to suit yourself.
However, the COM port setting MUST remain as COM0 to indicate
a local logon. Changing the security level, time remaining,
etc., is up to you. After editing, place the file into your
QuickBBS system directory and leave it there.
Direct Screen Writes
--------------------
1-Edit defaults to using direct screen writes when you're
logged on locally. This speeds up the program immensely but
may cause problems with some multitaskers. The command line
parameter -D will disable these direct screen writes, forcing
all screen writes through DOS. More on this and other command
line parameters is detailed later.
Locked COM Ports
----------------
Locked ports are supported automatically by 1-Edit. No need
to use DORSPEED, SETSPEED, etc. 1-Edit has been successfully
tested at up to 38,400 baud.
Directories
-----------
1-Edit may be run from whatever directory you choose
provided you have the environment QUICK set (i.e.
"SET QUICK=C:\QBBS\". See your DOS manual for more details on
setting and using environment variables.) If you DON'T set
the QUICK variable, you MUST run 1-Edit from your main
QuickBBS directory.
When first started, 1-Edit looks for the above mentioned
environment variable. If found, 1-Edit then looks there for
your configuration files. If not found, 1-Edit assumes that
the config files are in the current working directory.
QUICKCFG.DAT is then read to check the location of your menu
directory and USERS.BBS file. Local screen messages will tell
you what's going on, which path the program is choosing, etc.
Okay, so now you've unarchived the program and put it
somewhere on your harddrive, paying attention to the QUICK
variable (if set, 1-Edit can go anywhere; if not, 1-Edit must
1-Edit Documentation Page 6
be in your main QuickBBS directory). You've also put the
LOCAL.DEF file into your main QuickBBS directory (regardless
of what QUICK is set to, LOCAL.DEF belongs in the main
directory.) Now you're almost ready to get started.
1-Edit Documentation Page 7
+---------------------------------------------+
| COMMAND LINE SYNTAX |
+---------------------------------------------+
1-Edit allows you to customize it somewhat via the command
line. All of the following command line parameters are
optional:
-Nxxxxxx Tells 1-Edit to look in path xxxxxx for the
DORINFO1.DEF, LOCAL.DEF, and QUICKCFG.DAT
files. Example: "-Nc:\qbbs\line1" or
"-Nc:\qbbs\line*N" (which lets QuickBBS insert the
actual node number in place of *N). A trailing
backslash is optional. The actual drive and path
statement is also optional. If left blank 1-Edit
will first search the current directory for the
necessary files before attempting to find them
elsewhere.
-Uxxxxxx Tells 1-Edit to look in path xxxxxx for the
USERS.BBS file. Example: "-Uc:\qbbs\users"
A trailing backslash is optional. This is a
rarely used command.
-Fxx Sets foreground color to xx. xx must be 0-15.
Default color is bright cyan (#11). Example: -F6
-Hxx Sets the highlight color to xx. xx must be
0-15. Default highlight color is bright yellow
(#14). Example: -H12
-Sxxxxx Sets the minimum security level for accessing
the Drop To DOS feature to xxxxx. xxxxx must
be 0-64000. Default is 32000. (More on this
feature later.) Example: -S100
-D Stops 1-Edit from using direct screen writes with
local logons. With this parameter all screen
writes will be through DOS. Remote logons will
have all writes sent through DOS, regardless of
this parameter.
-J Turns on security "jumping." More on this
later.
-M Causes 1-Edit to not allow menu editing. The
menu editor won't even show up on the main menu.
1-Edit Documentation Page 8
-X For use with the QuickBBS *W command that allows
users to jump straight from reading messages into
an external user editor, so that you may
immediately edit the user record of the message's
author. Example: -X*W
? or -? Brings up a short help screen outlining these
command line parameters.
None of these parameters are required; use any, all, or none
of them as you choose. You may use them in any order and case
doesn't matter. Several of these are discussed in more detail
later, so don't worry if you don't yet understand their uses.
1-Edit Documentation Page 9
+---------------------------------------------+
| GETTING STARTED |
+---------------------------------------------+
With that stuff out of the way, we'll get on to the meat of
the program and how to make it run. I won't bother taking you
through each and every option of both editors -- most
everything is self-explanatory so I'll just touch on some
things and highlight the few oddities. Any sysop that has
gotten QuickBBS up and running shouldn't have any problems.
Setting Up A Menu For 1-Edit
----------------------------
1-Edit works both as a Type 7 or a Type 15 door. However,
there's no need that I can see to ever run it as a Type 15.
Even under very tight memory constraints, the Type 7 (used
with QuickBBS's *M data line parameter) should work fine. By
the way, the *M parameter causes QuickBBS to swap itself to
EMS or disk during the Type 7 shell, leaving you with nearly
all of your available DOS to run 1-Edit.
Here's a sample of a Type 7 setup as it would look from within
the new Menuedit:
------(this screen has been edited to fit the page)----
┌───────────────────────────────────────────────────────────
│ Editing Entry #: 21
│ 1 2 3 4 5
│12345678901234567890123456789012345678901234567890123456789
│<1> .............. Use 1-Edit Remote Editor················
│
│Optional Data:
│1-EDIT.EXE *M··············································
│
│Menu Type....>7··
│Security.....>50··· ╓──────────────────────Keys In Use─────
│Key..........>1 ║?????ABCDFGLMOTUVY#1?
│ForeGround...>11 ╙───────────────────────────────────────
│BackGround...>0·
│A Flags......>X------- ╔════════════════════Shift-FKeys═════
│B Flags......>-------- ║ F1-┌ F2-┐ F3-└ F4-┘ F5-─ F6-│ F7-├
│C Flags......>-------- ║ (Use ALT-FKeys To Change Ch
│D Flags......>-------- ╚════════════════════════════════════
│
│ [F1] to Finish and Save Changes
1-Edit Documentation Page 10
│ [ESC] To Abort Changes To This Entry
│ [HOME]-Beginning of Line, [END]-End of Line, [INS]-Toggl
│ [F2]-Center Display Line, [F10]-Menu Type Hel
│
└────────────────────────────────────────────────────────────
---------------------------------------------------------
I think that gives you the basic idea of what it looks like.
If you choose to use some of 1-Edit's command line options,
the above data line might read:
Optional Data:
1edit.exe *M -Nc:\qbbs\line*N -F7 -H15 -J
Note that the above uses both the QuickBBS *N and *M
parameters: *M to swap QuickBBS to EMS or disk; *N causes
QuickBBS to put the current node number in place of the *N.
See your QuickBBS docs for more info on these and other usable
Type 7 parameters.
The QuickBBS *W Command
-----------------------
This new command, added into v2.76, allows you to jump
directly from reading messages to an external user editor. To
set up 1-Edit for this type of operation, go into QCONFIG
under GENERAL then OTHER. At the bottom of the page is a
field for External User Editor. Set yours up something like
this:
1EDIT.EXE *M -X*W
You may use any additional command line parameters you wish,
and you may leave off the *M command (swaps QuickBBS to disk
or EMS when 1-Edit loads) if you wish. Note: There should be
NO SPACES BETWEEN -X AND *W. Jam them right together. Now,
when you're reading messages in QuickBBS and hit the
"<O>ptions" then "<U>ser" commands, you'll jump straight from
the BBS into 1-Edit's user editor, landing on the proper user
record -- provided that user's record can be found. 1-Edit
will search both the Name and Alias fields for a match. If no
match is found you'll be notified and, after pressing [ENTER],
you'll exit straight out of 1-Edit back in to QuickBBS.
1-Edit Documentation Page 11
Actual Startup
--------------
When you first crank up 1-Edit, it will check to see that a
FOSSIL is present. If not, the program aborts. From there it
begins its search for QUICKCFG.DAT and DORINFO1.DEF, using
LOCAL.DEF if necessary. Some values are initialized and
you're told (on the local screen only) where it's taking the
files from. Then an opening screen pops up. If the program
is unregistered, the program will ring the bell a few times,
then pause for 4 seconds to <ahem> encourage registration.
After the pause you'll be prompted to "Press [ENTER] to
continue:". Press Enter and you'll get the main menu.
From the main menu you may choose to edit the user files, menu
files, or drop to DOS. At this point, registered versions of
1-Edit will show a status line on the local console detailing
who's online, baud and modem settings, and time remaining.
Unregistered versions show only the line "Unregistered
Evaluation Copy".
A quick side note: Throughout most of the program, pressing
[ENTER] or entering a question mark ("?") at any menu will
redraw the screen. This is really only useful in times of
high line noise but it's nice to have available when you need
it.
1-Edit Documentation Page 12
+---------------------------------------------+
| THE MENU EDITOR |
+---------------------------------------------+
Those of you familiar with Adam Hudson's original Menuedit
program will feel right at home here. When you first choose
the menu editor from the main menu, you'll be presented with a
list of the menus in your QuickBBS menu directory. After
displaying all of the menus you'll have the option of
editing/adding a menu, renaming a menu, copying a menu,
deleting a menu, or relisting the files.
There's no need to explain most of these functions. One thing
you might like to know is that any rename, delete, or copy
operation can be stopped by pressing [ENTER] on a blank input
field.
Choose the <E> option and you'll be prompted for the menu
name. If the menu isn't found, you'll be asked if you wish to
create it. If the menu exists, or if you do want to create
it, you'll be dropped into the actual menu editor. From here
you can do a variety of things, all very similar to the old
Menuedit.
Rather than beat a dead horse trying to detail each and every
function of this editor, you should just play with the thing
for a while. Copy an existing menu to another menu file
called TEST or FRED or something. Then hack away on the
copied menu. You'll get the hang of it in no time.
Something you should know: When "<C>hanging" a menu line (this
is how you actually edit an existing menu) you may move from
menu line to menu line by pressing the plus (+) or minus (-)
keys to move forward or backward. Users who have their modem
Escape Guard Time (S12) set too low may have problems with the
plus key, and may use the < or > keys to move around. When
you hit the beginning or end of a menu, the editor will "wrap
around" from the end to the beginning, or vice versa.
Example: You have a 20 line menu. At line 20 you hit the plus
key. You will "wrap around" to line 1.
Oh, something else you should know: When editing a field in
either editor (menu or user), as soon as you punch [ENTER] the
new value, if it's not blank, is written to disk. If it *is*
blank, nothing is written and you exit the procedure. The
immediate write to disk is done so that, should carrier drop
unexpectedly, all of your changes are already stored.
1-Edit Documentation Page 13
Okay, one last thing to tell you: If you have a copy of
Menuedit's MENUEDIT.HLP file in your system directory, 1-Edit
will read this file when you're adding or changing a line of a
menu. This help file contains a thumbnail sketch of all the
different menu types -- which is handy to have when a printed
copy of the docs isn't easily available.
1-Edit Documentation Page 14
+---------------------------------------------+
| THE USER EDITOR |
+---------------------------------------------+
Most all of this section should be pretty easy to figure out.
Press the plus (+) key to move the next user, or the minus (-)
key to move to the previous user. Again, if you have problems
with + or - you may use < or > instead. When moving from user
to user, if you hit the beginning or end of the USERS.BBS
file, the program will "wrap around" to the next user.
Example: You come to the last user in the file, say it's user
#100, then press the plus key (+) one more time. The program
will "wrap around" back to user #0 (the first user in the
file).
Pick and choose any fields you want to edit, press the
bracketed key <>, and you can edit away. Should you start to
edit a field, then decide against it, just press [ENTER] over
a blank edit field and that field will remain unchanged.
At the bottom of the screen you'll see a small window with
choices to add a user, delete a user, find a user, etc.
<Q>uit takes you back to the main menu. <O>ther clears this
small window and replaces it with a second window of other
editing options. To return to the first set of options, press
<O> again.
Mass Updates
------------
With 1-Edit, you have the ability to do two types of mass
updating (changes made to every user in the file). You can do
mass updates of a flag. For example, you could turn every
user's B1 flag ON.
You may also mass update everyone's "High Message Read"
number. This is something you won't need often, if ever, but
it's handy to have. The usual reason for changing everyone's
High Message Read is after blowing up your message base
through some botched operation, leaving you with no choice but
to delete all the message files and start over again.
1-Edit Documentation Page 15
Security "Jumping" (aka "the -J parameter")
-------------------------------------------
By default, any user that has access to 1-Edit can edit *any*
user record. (See below about editing your own record.) For
some sysops, those with remote cosysops, this can sometimes
cause a problem. You may wish to allow a user to edit *some*
user records, but not all. That's what the "-J" does. Add it
to your 1-Edit command line and the program will conveniently
skip any record in the USERS.BBS where the security level is
greater than the user's own security level. For example, say
your remote sysop has a security level of 100. With the "-J"
on the command line, 1-Edit won't let him/her even see, much
less edit, records where the security level is 101 or greater.
Also, unlike previous versions, the user won't be able to
raise anyone's level higher than his/her own nor will he/she
be able to add a new user with a higher level.
Editing Your Own User Record
----------------------------
To put it simply, you can't do it with 1-Edit. 1-Edit edits
only the USERS.BBS and related files and doesn't work with the
EXITINFO.BBS file at all. I hear about this "bug" all the
time. People tell me how they went in and changed several
fields in their own record, only to exit 1-Edit and QuickBBS
and find that the changes mysteriously disappeared. The
reason is pretty simple and goes all the way back to the very
first versions of QuickBBS.
Here's what happens: When a user logs onto QuickBBS, his or
her user record is read into memory. Any changes that
QuickBBS would make to that record are held in memory (but not
written to disk) until the user logs off. At logoff, the
user's record is completely rewritten by QuickBBS with the new
data. If, during the user's online session, the user changes
his/her own record, those changes are written to disk by
1-Edit -- but those changes are completely overwritten again
by QuickBBS at logoff.
The simplest way around this (with 1-Edit) is to logon using
another name (maybe create a user account called "Test User"
or somesuch), edit your "real" user record, then log off. Or
wait to make changes to your record until you can do so by
running a user editor directly from DOS.
1-Edit Documentation Page 16
1-Edit Lite (1EDITL.EXE)
------------------------
I've had a few requests in the past from sysops who like
1-Edit but really have no use for the menu editor. For them
I've created 1-Edit Lite, a slightly smaller version of 1-Edit
that contains only the user editor. You move directly from
the opening title screen to the user editor with no stops
inbetween. 1-Edit Lite functions exactly the same as 1-Edit,
minus the menu editor and drop to DOS feature (see below).
All command line parameters are supported in the Lite version.
Really, there's no difference in the code except the menu
editing routines weren't compiled in.
1-Edit Documentation Page 17
+---------------------------------------------+
| DROP TO DOS FEATURE |
+---------------------------------------------+
Please read this section carefully!
Dropping to DOS through 1-Edit can be handy at times but can
also lock your computer up if you don't pay attention to what
you're doing.
Before attempting to use this feature, double check that the
DOS environment variable COMSPEC is set properly. To check
this, type SET at a DOS prompt. Your environment will be
displayed for you. You should see "COMSPEC=" and the
drive/path to your COMMAND.COM file. If this *isn't* set
properly, please consult your DOS manual.
When displaying the main menu, 1-Edit checks the user's
security level (as set in DORINFO1.DEF) against the security
level set on the command line (or the default value, 32000).
If the user's level equals or exceeds that level, the Drop to
DOS function appears on the main menu. If the user's level is
*less* than the specified level, the option doesn't appear and
won't function. This allows you to have cosysops helping you
edit your user and menu records without actually allowing them
to enter DOS.
Drop to DOS works two different ways, depending on whether
you're using the program locally or remotely.
Local Drop to DOS
-----------------
When in local mode, the Drop to DOS is just a very simple
shell. You hit "D" and you get the familiar flashing cursor.
(What actually happens is a second copy of COMMAND.COM is
loaded.) You may run whatever you need to run from here.
When you're ready to return to 1-Edit, just type EXIT and
press [ENTER].
Remote Drop to DOS
------------------
Things get a little more complicated when dropping to DOS
remotely. First, when you do drop to DOS, 1-Edit goes on
1-Edit Documentation Page 18
hold. It no longer monitors carrier, it doesn't feed screen
displays to the modem or read incoming data from the modem,
nor does the user inactivity timeout function work. This is
exactly the same as when you shell out from QuickBBS via a
Type 7 or 15 menu option -- all BBS functions stop cold.
Whatever you run here *must* be able to send info through the
modem, read incoming data from the modem, and check carrier.
QuickBBS won't do it for you after executing a Type 7 or 15
menu option, and 1-Edit won't do it for you when you <D>rop to
DOS.
When you do execute the Drop to DOS remotely, you'll be
prompted for a filename to execute. Leave this field blank
and you'll be returned to 1-Edit. If you do execute a program
or batch file, you MUST INCLUDE THE FILE EXTENSION WITH THE
FILENAME (i.e. ".EXE", ".COM", ".BAT"). You may also include
as many command line parameters as will fit into the field.
The parameters will be passed on to the child program. When
you exit the child program, you'll be returned to 1-Edit
automatically.
DOSSHELL.BAT
------------
A sample batch file called DOSSHELL.BAT is included in the
1-Edit archive for you to look over. It details how you can
set up a true "drop to DOS" from 1-Edit using CTTY.COM or
Gateway. THIS IS NOT MEANT TO BE A READY-TO-RUN BATCH FILE!
Use it only as a guide. If you do decide to try it out, be
sure to pass your baud rate to DOSSHELL.BAT on the command
line as: DOSSHELL.BAT 2400 (or whatever baud rate you're
using.) You should read and test this batch file carefully
before relying on it!!! I can't stress that enough. Also,
you should add to it some sort of carrier detect TSR, like
WATCHCD, before using it. WATCHCD (and the related BOOT.COM)
are available in all versions of the X00 FOSSIL driver.
Better yet, get a copy of DOORWAY, a great program that lets
you run nearly anything as a door with complete carrier
detection. It's shareware and registration is pretty cheap.
1-Edit Documentation Page 19
+---------------------------------------------+
| USING 1-Edit ON MULTI-NODE SETUPS |
+---------------------------------------------+
Typically when running a multi-node QuickBBS set up, you will
have your directories set similar to this:
C:\QBBS\ = Main System Directory. Your QUICK
environment variable points here.
C:\QBBS\NODEx\ = Separate directories for each node that
you run, where "x" equals the node
number.
Your actual directory names may be different though many
people seem to follow this example as outlined in the QuickBBS
docs.
Under single node setups, your config files (QUICKCFG.DAT et
al) live in the System directory. This is also where QuickBBS
puts the DORINFO1.DEF file when executing a Type 7 or Type 15
menu option. Under multi-node setups, the config files live
in each line directory, and the DORINFO1.DEF is placed in the
proper line directory, too. Under these situations, you'll
need the following parameter to help 1-Edit figure out what is
going on and where to look for files:
The -N Parameter
----------------
When 1-Edit detects the -N parameter on the command line, it
will search the directory specified after the -N for both the
DORINFO1.DEF file and the QUICKCFG.DAT file. If the files are
found, they will be used. If either file is not found in the
specified directory, 1-Edit will fall back and attempt to
locate the files in the main System directory.
In the case of the QUICKCFG.DAT file being missing from both
the specified -N parameter directory *and* from the System
directory (pretty much impossible if your system actually
works), the program will abort.
If the DORINFO1.DEF file isn't found in the -N specified
directory nor in the System directory, 1-Edit will search the
System directory for the LOCAL.DEF file. There's no need to
put a copy of LOCAL.DEF into each line directory; one copy in
1-Edit Documentation Page 20
the System directory is all that's needed.
However, if the -N parameter is used by itself, with no path
immediately following it, 1-Edit will look for QUICKCFG.DAT
and DORINFO1.DEF first in the *current directory*, then will
fall back to searching the system directory.
Here's an example of the -N parameter in use:
1EDIT.EXE -Nc:\qbbs\node1
- or -
1EDIT.EXE -Nc:\qbbs\node*N
- or -
1EDIT.EXE -N
A trailing backslash is optional. Note the "*N" in the second
example. This utilizes a feature of QuickBBS (mentioned
earlier) where QuickBBS will substitute the node number for
the "*N" when executing a Type 7 or Type 15 shell.
The -U Parameter
----------------
This tells 1-Edit to get the USERS.BBS from the directory
specified after the -U. Example:
1EDIT.EXE -Uc:\qbbs\users\
As before, a trailing backslash is optional.
This is probably not going to be the most used parameter as
most folks maintain only a single user file. But just in
case, it's here...
One thing to note about this parameter's use: If 1-Edit can't
find the USERS.BBS file in the specified directory, the
program won't search elsewhere for it. It will simply abort
with an error code.
1-Edit Documentation Page 21
+---------------------------------------------+
| REGISTERING 1-EDIT |
+---------------------------------------------+
Keys
----
1-Edit uses a "keyed" registration system similar to that used
by QuickBBS. The information contained in your QUICKCFG.DAT
file under Sysop Name and BBS Name are used to create your
key. Unregistered versions of the program (programs running
without the key) ring the bell and have a 4 second pause built
into the beginning of the program. Also, the status line is
disabled. Registered versions of the program kill the beeping
and 4 second pause and enable the status line. Registered
versions also show the sysop name and system name on the title
screen when 1-Edit is started. These are the ONLY differences
between registered and unregistered. There are no built-in
self-destruct mechanisms or anything like that.
When you register 1-Edit, you will receive a small key file
that will disable the ringing and pause, and enable the status
line. If you're a member of Fidonet, your key file will be
delivered by netmail file attach. If you're not in Fidonet, I
may try to upload your key to your BBS (if you're in the
continental U.S. or English-speaking Canada). If I'm unable
to get through, or if you're outside the continental U.S. and
Canada, I'll send the key through regular mail. I've found
Fidonet delivery to be faster, cheaper, and easier, regardless
of where you are in the world, so I attempt to use that method
whenever possible. Uploads to your BBS are usually the second
fastest, cheapest method. Snail mail gets used only if
there's no other inexpensive way to get the key to you.
Installing Keys
---------------
When you receive your keyfile, it may come to you named
something like LASTNAME.KEY (where LASTNAME is your lastname).
If so, please rename it to 1EDIT.KEY, and place it into your
main QuickBBS System directory. Be very careful with the
filename of this key: It must be called 1EDIT.KEY (and NOT
1-EDIT.KEY).
Leave this key in place for as long as you use 1-Edit. It
will be good for all future versions of the program. Or, if
1-Edit Documentation Page 22
for some reason I change the key encryption in a future
version, I'll send you a new key before releasing the new
version.
F.Y.I.: There's no difference between the keys for the
QuickBBS version of this program and the RemoteAccess version
(1-Edit-RA) except the filename. If you are switching to
QuickBBS from RA and have a valid key for 1-Edit-RA, just
rename the key to 1EDIT.KEY.
Registering
-----------
A form is included in the program archive. Please complete
the form and mail it along with your check or money order for
$10.00 (U.S. funds only) to the address on the form. Your key
will be sent to you within a few days of receipt.
Please be VERY careful when completing the registration form
that your Sysop Name and BBS Name are EXACTLY as they appear
in your QuickBBS configuration.
1-Edit Documentation Page 23
+---------------------------------------------+
| THE END |
+---------------------------------------------+
Okay, I guess that covers it. Hopefully this file is complete
enough that you can figure out how to use the program. Should
you encounter a problem of some sort or an unfound bug, please
be sure to let me know. Suggestions for enhancements are
always welcome, to.
You can contact me via the QuickBBS Support echo, the QuickPRO
echo, by netmail, or by regular mail.
The current version of this program will always be available
for file request or first call download on my system. File
request the magic name: 1EDIT
-Bob Ransom
27840 Lathrup Blvd.
Lathrup Village, Michigan 48076
U.S.A.
The Creative Connection BBS
24 hours / 7 days
300-1200-2400 baud / 8-N-1
(313) 559-9039
Fidonet 1:120/96
1-Edit Documentation Page 24